home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 1: Collection A / 17Bit_Collection_A.iso / files / 1160.dms / 1160.adf / The Manual < prev    next >
Text File  |  1990-10-15  |  26KB  |  651 lines
  1. d
  2.  
  3.                                SuperTex
  4.                       Videotex Terminal Emulator
  5.                              Version 2.1
  6.            Copyright 1986, 1987  Ron Wright and Peter Story
  7.  
  8. 26th September 1990
  9.  
  10. There appears to be no official documentation concerning the operation
  11. of SuperTex. Whilst the operation of the program is fairly obvious,
  12. there are some points which are not and this document attempts to
  13. rectify this.
  14.  
  15. I make no claims as to the completeness or accuracy of this document's
  16. contents and am sure that I must have missed out many of SuperTex's
  17. hidden features. If so, I apologise.
  18.  
  19.  
  20.                          Chapter 1. OVERVIEW
  21.                          -------------------
  22.  
  23. SuperTex is a communications program for use with Videotex/Viewdata
  24. services. The program is Australian in origin and was written for use
  25. with the Australian Viatel service. In most respects, it functions
  26. equally as well with the British Prestel service, but there are slight
  27. differences, notably with respect to the way that the CET telesoftware
  28. downloader is implemented. These differences and their effects are
  29. discussed later.
  30.  
  31. SuperTex may be used with intelligent modems, typically of the Hayes
  32. compatible type, or with dumb modems of the non-buffered, manual type.
  33. Connections at speeds of 300, 1200/1200, 2400/2400 or 1200/75 bps are
  34. all supported.
  35.  
  36.  
  37.                     Chapter 2. INSTALLING SUPERTEX
  38.                     ------------------------------
  39.  
  40. SuperTex is normally supplied without any of the niceties of life like
  41. icons and documentation and usually consists of a single program file
  42. called 'SuperTex'.
  43.  
  44. As a result, the program must initially be set up from the CLI, but,
  45. once set up, it may be used from the WorkBench without any trouble, if
  46. preferred.
  47.  
  48. However, Micronet have partially configured your copy of Supertex so
  49. that the hard work has already been done. If you have not already done
  50. so, please read the READMEFIRST document included on your disc, which
  51. will tell you what to do to run the program.
  52.  
  53. You will still have to input your local Prestel telephone number and
  54. details of your modem speed, as with most comms programs.
  55.  
  56. The following installation notes may be used if you wish to set up
  57. further configurations for Supertex. You are strongly recommended to
  58. make one or more backup copies of Supertex before doing so, however.
  59.  
  60. It is assumed throughout this documentation that you have at least a
  61. basic knowledge of the Amiga and its operating system and also how to
  62. use the CLI. If you do not know how to create new drawers, use the
  63. CLI, or copy files using the CLI, you should consult the Amiga manual
  64. before proceeding further.
  65.  
  66. SuperTex may be installed on floppy or hard disk. If installing on a
  67. hard disk, a drawer called SuperTex should be created. This will be
  68. used for all SuperTex related files. If installing onto a floppy disk,
  69. a blank, but formatted, disk will be required.
  70.  
  71. Several drawers will also need to be created, either within the
  72. SuperTex drawer on a hard disk, or the root of a floppy disk. Drawers
  73. can be created from WorkBench by clicking on an empty Drawer icon and
  74. selecting the Duplicate option in the WorkBench Menu, then clicking on
  75. the new 'copy of' drawer and using the Rename option to rename the
  76. drawer. Alternatively, new drawers can be created from the CLI using
  77. the MAKEDIR command and then copying another drawer '.info' file and
  78. giving it the same name as the drawer created. If you are not sure how
  79. to do this, use the WorkBench method!
  80.  
  81. The four drawers required should be given the following names.
  82.  
  83.     CAROUSEL
  84.     CONFIG
  85.     SCREENS
  86.     TEXT
  87.  
  88. Open a CLI window and copy the SuperTex program file into the SuperTex
  89. drawer on a hard disk, or the root of a floppy, using the COPY
  90. command.
  91.  
  92. Examples:-
  93.      COPY  DF0:SuperTex  DF1:          to copy from a floppy in DF0:
  94.                                        to DF1:
  95.  
  96.      COPY  DF0:SuperTex  DH0:SuperTex  to copy from DF0: to the
  97.                                        SuperTex drawer on DH0:
  98.  
  99. (change the drive letters as required)
  100.  
  101.  
  102. The installation is now virtually complete but it is still necessary
  103. to run SuperTex from the CLI for the first time at least. Select the
  104. drawer containing the SuperTex file and then type:-
  105.  
  106.     SUPERTEX
  107.  
  108. The program will start to load and after a few seconds a SuperTex
  109. Error Message will appear, telling you that the configuration file was
  110. not found and that the default configuration will be used. Click on
  111. the Proceed button and SuperTex will continue to load and then present
  112. you with its opening screen. As we are only really interested in
  113. setting up SuperTex at the moment, we shall just perform a basic
  114. configuration initially.
  115.  
  116. Click on the 'Viatel' entry in the SuperTex Configuration requester in
  117. the lower part of the screen. This will open the Modem Settings
  118. requester. Change the Service entry to 'Prestel' and then enter the
  119. telephone number of your local Prestel access point in the Number
  120. entry. Click on the Accept button.
  121.  
  122. If your modem is Hayes compatible, click on the Manual Dial entry.
  123. This will take you back into the Modem Settings requester so that you
  124. can change the Modem Prefix to suit your modem, or select Tone
  125. dialling etc. On return, the setting will now show Auto Dial.
  126.  
  127. Click repeatedly on the entries which show speed, Parity and Duplex
  128. settings, to change them to what you require. Normally, you will
  129. require Full Duplex and Even Parity and the fastest speed that your
  130. modem supports.
  131.  
  132. You can choose whether your ID and password will be automatically sent
  133. or not. If the SuperTex Configuration window shows 'Manual ID' the
  134. program is configured not to send the ID. Clicking on this will open
  135. the Modem Settings requester and allow you to enter your ID.
  136.  
  137. All necessary changes have now been made, so you can click on the
  138. Local button to go into local mode. The lower part of the screen will
  139. clear. Select the pull down menus by clicking and holding down the
  140. right mouse button, pull down the Config Menu and select the Save
  141. Config option.
  142.  
  143. SuperTex's file selector will be displayed. You should find that the
  144. 'Drawer' entry contains the entry "CONFIG", indicating that is the
  145. drawer into which the configuration will be saved.
  146.  
  147. Type:-
  148.  
  149.     Default
  150.  
  151. as the Filename, then click on the Save Button. The configuration will
  152. be saved.
  153.  
  154. Note: A configuration file with the name 'Default' is automatically
  155. looked for by SuperTex. If it is not found, an error message will be
  156. displayed every time SuperTex is loaded.
  157.  
  158. SuperTex will always load this default configuration, either from the
  159. CLI or WorkBench, unless another configuration file name is provided.
  160.  
  161. You can now pull down the Project Menu and select the Quit option to
  162. return to the CLI prompt and then to WorkBench if you prefer.
  163.  
  164.  
  165.                 Chapter 3. LOADING AND USING SUPERTEX
  166.                 -------------------------------------
  167.  
  168. Once installed correctly, SuperTex may be run either from the CLI or
  169. from WorkBench.
  170.  
  171. a). Loading from WorkBench
  172.  
  173.     Select the CONFIG drawer and double click on the 'Default'
  174.     configuration icon. The Default configuration will be loaded with
  175.     SuperTex.
  176.  
  177.     You may create as many different configurations as you want,
  178.     saving each with a different name. This is particularly useful as
  179.     SuperTex does not maintain a dialling directory as some other
  180.     programs do. Instead, each configuration file contains the details
  181.     for a single service, so that different configuration files allow
  182.     you to automatically configure SuperTex for different services,
  183.     complete with different macros and indexes.
  184.  
  185.     SuperTex may also be loaded by double clicking on any Carousel,
  186.     Screen or Text file icons which have been created by SuperTex.
  187.  
  188. b). Loading from the CLI
  189.  
  190.     To run SuperTex from the CLI, select the drawer containing
  191.     SuperTex as the current drawer and enter
  192.  
  193.          SUPERTEX
  194.  
  195.     This will load SuperTex and the Default configuration you created.
  196.     Alternatively, you can load SuperTex and another configuration
  197.     file by typing
  198.  
  199.          SUPERTEX CONFIG/Prestel
  200.  
  201.     which will load a configuration file called 'Prestel' in the
  202.     CONFIG drawer.
  203.  
  204.  
  205. Once loaded, you have two choices. You can either go straight on line
  206. by selecting the 'Connect' button, or you can use the 'Local' button
  207. to go into local mode. Local mode allows you to load existing frames
  208. for viewing and so on. You can also go on line from Local mode by
  209. selecting the service entry in the Dial Menu.
  210.  
  211. If you are using a Hayes type modem SuperTex will then cause the modem
  212. to dial the specified number and connect.
  213.  
  214. If you are using a 'dumb' modem, you will have to dial the number
  215. yourself and once the carrier is heard, click on the Connect button to
  216. go on line.
  217.  
  218. Note: Certain keys are redefined for ease of use and these are
  219. described in full at the end of this document, but it is important to
  220. be aware that the hash '#' that Prestel expects to receive may be
  221. produced in SuperTex either by using the hash key, or the small enter
  222. key on the numeric pad.
  223.  
  224.  
  225.                       Chapter 4. PULL DOWN MENUS
  226.                       --------------------------
  227.  
  228. SuperTex's pull down menus are available at all times in either Local
  229. mode or whilst on line and are accessed by holding down the right
  230. mouse button, which will display the menu bar, and then moving the
  231. pointer to the menu required and, finally, the option required. Some
  232. menus lead to further sub-menus which are accessed in the same way.
  233. Releasing the right button whilst the required option is highlighted
  234. selects it.
  235.  
  236. This chapter describes the purpose of all the options in the pull down
  237. menus.
  238.  
  239.  
  240. Project Menu
  241. ------------
  242.  
  243. About            - Displays a copyright message
  244.  
  245.  
  246. Save Screen
  247.                    Produces a sub-menu offering:-
  248.  
  249.     Graphics     - Saves the current screen to file as a graphics
  250.                    file.
  251.  
  252.                    The File selector is displayed for you to enter a
  253.                    name for the file.
  254.  
  255.                    Note that files saved with this option have their
  256.                    own icon. Double clicking on one of these icons
  257.                    will load SuperTex and the chosen frame.
  258.  
  259.     Text         - Saves all ASCII characters in the current screen to
  260.                    file to a text file.
  261.  
  262. Load Screen      - Loads and displays a screen previously saved with
  263.                    the 'Save Screen - Graphics' option.
  264.  
  265. Telesoftware     - Activates the Telesoftware downloader to download
  266.                    files in CET format.
  267.  
  268.                    IMPORTANT NOTE: The CET Telesoftware provided on
  269.                    the Australian Viatel service has a number of small
  270.                    differences from the specification used in the UK
  271.                    on Prestel.
  272.  
  273.                    Micronet have made minor changes to the way that
  274.                    Amiga Telesoftware is made available on Prestel, in
  275.                    order to ensure that it may be downloaded with
  276.                    SuperTex and other Australian programs.
  277.  
  278.                    There are two points which should be noted though.
  279.  
  280.                    a). Trying to download software for another machine
  281.                        using SuperTex will usually result in SuperTex
  282.                        producing error messages.
  283.                    b). Trying to download Amiga software using a CET
  284.                        downloader on another make of computer should
  285.                        not cause any problems. If it does, it is a
  286.                        fault in that programs CET downloader.
  287.  
  288. Print Text
  289.                    Produces a sub-menu with the following options:-
  290.  
  291.     Screen       - Prints the current screen in text mode.
  292.  
  293.     Carousel     - Prints text from all screens stored in the
  294.                    carousel.
  295.     Select       - Allows you to select which frames from the carousel
  296.                    are to be sent to the printer as text.
  297.  
  298. Print Graphics
  299.     Half Width   - Prints a half width graphics dump of the current
  300.                    screen.
  301.     Full Width   - Prints a full width graphics dump of the current
  302.                    screen.
  303.  
  304. Quit             - Exits the program.
  305.  
  306.  
  307.  
  308. Index Menu
  309. ----------
  310.  
  311.                    The Index Menu provides facilities to create up to
  312.                    70 frame numbers or keywords to be called up with a
  313.                    couple of clicks of the mouse when required.
  314.  
  315. Create Index     - Create an index of frame numbers for subsequent
  316.                    recall.
  317.  
  318.                    Selecting this option produces the Page Index
  319.                    Requester. This allows you to enter a Topic as a
  320.                    description. The Topic is displayed in the Index
  321.                    Menu once an index has been created.
  322.  
  323.                    Up to 10 indexes may be created for each
  324.                    configuration and each index may contain seven
  325.                    entries. Each Entry consists of two parts. The left
  326.                    column should contain the page number or keyword.
  327.                    Each number or keyword should be preceded by a star
  328.                    '*' and terminated with a hash '#'. The right hand
  329.                    column a description of what that page contains.
  330.  
  331.                    It is also possible to enter route numbers from a
  332.                    frame, but the total number of characters that may
  333.                    be transmitted is 11.
  334.  
  335. (other entries)  - Up to 10 entries may be displayed, each being the
  336.                    Topic given to an index created with the Create
  337.                    Index option.
  338.  
  339.                    Once an index has been created, its Topic entry is
  340.                    displayed in the pull down menu. Selecting a topic
  341.                    displays a menu showing the numbers and their
  342.                    descriptions. Also displayed is an entry 'Modify
  343.                    Index' which takes you to the Page Index requester
  344.                    so that changes can be made.
  345.  
  346.                    Selecting a number causes the number to be
  347.                    transmitted to the service.
  348.  
  349.  
  350. Store Menu
  351. ----------
  352.  
  353. SuperTex maintains a carousel buffer, capable of storing up to 30
  354. frames. Frames my be placed into this carousel and viewed, saved to
  355. disk, printed etc. Carousel stores are referred to as 0-9 and A-T.
  356.  
  357. Store Next       - Store the current frame into the next available
  358.                    frame store in the carousel.
  359.  
  360.                    This is equivalent to pressing the Del key.
  361.  
  362.  
  363. Store Select     - Store the current frame into a selected carousel
  364.                    frame.
  365.  
  366.                    Selecting this option displays the carousel store
  367.                    reference characters, allowing you to select which
  368.                    you want to store the current frame into. Frames
  369.                    which already have something stored in them are
  370.                    shown in Red, but may still have new contents
  371.                    placed in them to overwrite the existing contents.
  372.  
  373. Recall Next      - Recall the next frame in the carousel to the
  374.                    screen.
  375.  
  376.                    This is equivalent to pressing Shift-Del.
  377.  
  378.                    Used to re-display the next frame in the carousel.
  379.  
  380. Recall Select    - Select frames from the carousel for re-display.
  381.  
  382.                    Allows a specific frame to be selected by selecting
  383.                    the frame character from the displayed list.
  384.  
  385. Display Rate     - Set the rate at which frames will change when using
  386.                    the Carousel Select or All, options.
  387.  
  388.                    5, 10, 15 or 20 second delay between display of the
  389.                    next frame may be selected.
  390.  
  391. Carousel Select  - Select one or more frames from the carousel to be
  392.                    displayed automatically.
  393.  
  394.                    Those frames which are to be displayed should be
  395.                    highlighted in the Carousel Frame Select requester
  396.                    and the Display button selected when ready.
  397.  
  398.                    The selected frames are then displayed one after
  399.                    another, with a time delay determined by the
  400.                    Display Rate setting. The display of frames may be
  401.                    cancelled using the Stop Carousel option.
  402.  
  403. Carousel All     - Select all carousel frames to be displayed
  404.                    automatically.
  405.  
  406.                    All frames are displayed, one after another, with a
  407.                    time delay determined by the Display Rate setting.
  408.                    The display of frames may be cancelled using the
  409.  
  410.                    Stop Carousel option.
  411.  
  412. Stop Carousel    - Stop automatically displaying Carousel frames.
  413.  
  414. Load Carousel    - Load a previously saved carousel into memory.
  415.  
  416.                    The required file may be selected using the
  417.                    SuperTex File Selector.
  418.  
  419. Save Carousel    - Save the contents of the current carousel to file.
  420.  
  421.                    The contents of the entire carousel may be saved to
  422.                    file for future viewing. Selecting this option
  423.                    presents the file selector.
  424.  
  425.                    Note that files saved with this option have their
  426.                    own icon. Double clicking on one of these icons
  427.                    will load SuperTex and the chosen carousel.
  428.  
  429.  
  430. Dial Menu
  431. ---------
  432.  
  433.  
  434. (Service name)   - Dial the current service.
  435.  
  436.                    There appears to be a slight bug in SuperTex here.
  437.                    Sometimes the default entry of Viatel will be
  438.                    displayed after a configuration has loaded, when
  439.                    the Service description from the Modem Settings
  440.                    requester ought to be displayed.
  441.  
  442.                    Selecting this option dials the service specified
  443.                    by the current configuration, using all its
  444.                    settings. The correct number is dialled,
  445.                    irrespective of what name is displayed in the menu.
  446.  
  447. Modify           - Change the settings for the current service.
  448.  
  449.                    This provides access to the Modem Settings
  450.                    Requester, allowing the number, Modem Prefix and
  451.                    Auto ID to be changed.
  452.  
  453. Hang Up          - Hang up the line.
  454.  
  455.                    When selected, this will drop the line when used
  456.                    with a Hayes compatible modem, but will be ignored
  457.                    with most manual modems.
  458.  
  459.                    The line should be physically disconnected or
  460.                    switched off when using a manual modem.
  461.  
  462.  
  463. Config Menu
  464. -----------
  465.  
  466. Speed            - Select the required line connection speed.
  467.  
  468.                    SuperTex supports the following line speeds:-
  469.  
  470.                            Bits per sec.
  471.                    V21     300/300
  472.                    V22     1200/1200
  473.                    V23     1200/75
  474.                    V22bis  2400/2400
  475.  
  476.                    and the required speed should be selected from the
  477.                    sub-menu.
  478.  
  479. Parity           - Select the required parity setting.
  480.  
  481.  
  482.                    Odd, Even and No parity settings are supported.
  483.                    Most Videotex services, such as Prestel, require
  484.                    Even selecting.
  485.  
  486. Duplex           - Select the required duplex setting.
  487.  
  488.                    Half and Full Duplex options are available. The
  489.                    Full duplex option will normally be required.
  490.  
  491. F Keys           - Configure the function key macros.
  492.  
  493.                    Function keys F1 to F10, when used with the Amiga
  494.                    key, will replay whatever macro is stored for that
  495.                    function key. This menu option allows you to define
  496.                    the macro text for each of these keys.
  497.  
  498.                    Macros are useful for transmitting frequently used
  499.                    sequences of keystrokes. These may be frame
  500.                    numbers, keywords, or ordinary text.
  501.  
  502.                    You might, for example set up a macro to transmit
  503.                    *AMIGA# whenever required. Alternatively, you might
  504.                    want to always put your name at the end of a
  505.                    message. Setting a macro up cuts the job to a
  506.                    single keystroke.
  507.  
  508.                    Any ASCII character that is normally acceptable to
  509.                    a Videotex service may be included in a macro, as
  510.                    also can Control codes produced with Ctrl and a
  511.                    letter key.
  512.  
  513.                    A slight quirk of SuperTex is that it will not
  514.                    transmit spaces, although it will accept them typed
  515.                    into a macro. The answer to this is to press the
  516.                    Tab key (or press Ctrl-I) wherever you want a space
  517.                    in a macro. This will be displayed as an inverse
  518.                    'I'.
  519.  
  520.                    Some useful control codes are:-
  521.  
  522.                    Ctrl - [    - Esc. Useful for sending colour
  523.                                  attribute sequences. Follow with the
  524.                                  character required to produce the
  525.                                  colour you want.
  526.                    Ctrl - H    - Moves cursor back one place.
  527.  
  528.                    Ctrl - I    - (Same as Tab key) Moves cursor
  529.                                  forward one place. Also equivalent to
  530.                                  inserting a space in most cases.
  531.                    Ctrl - J    - Moves cursor down one line.
  532.                    Ctrl - K    - Moves cursor up one line.
  533.                    Ctrl - M    - Return (moves to start of field on a
  534.                                  Videotex service).
  535.  
  536. Save Config      - Save the current configuration.
  537.  
  538.                    Selecting this option results in the SuperTex File
  539.                    Selector being displayed. The name you want to save
  540.                    the configuration with should be entered. If you
  541.                    are only altering an existing configuration, either
  542.                    enter the existing name, or select it from the list
  543.                    of existing configurations. Finally, click on the
  544.                    Save option.
  545.  
  546.                    SuperTex does not make use of dialling directories
  547.                    to hold details of Videotex services to be
  548.                    accessed. Instead, the configuration file contains
  549.                    details of all relevant settings, including
  550.                    telephone number, speed, parity etc. In addition,
  551.                    Function key macro definitions and Index
  552.                    definitions are saved as part of the configuration.
  553.  
  554.                    You can have as many configurations as you want,
  555.                    each saved with a different name. SuperTex
  556.                    automatically creates a file icon whenever you save
  557.                    a configuration.
  558.  
  559.                    Note that double clicking on one of these icons
  560.                    will load both SuperTex and the selected
  561.                    configuration.
  562.  
  563. Load Config      - Load an existing configuration.
  564.  
  565.                    This option enables you to load different
  566.                    configurations so that you can call other services
  567.                    without having to leave SuperTex and load it again
  568.                    with a new configuration.
  569.  
  570.                    The File Selector is displayed. Select the required
  571.                    configuration and click on Load.
  572.  
  573. Local Edit       - Enable/Disable Editing of the frame contents.
  574.  
  575.  
  576.                    This menu option is equivalent to pressing the Help
  577.                    key.
  578.  
  579.                    An 'Off' or 'On' sub-menu is offered. When turned
  580.                    on, the editing cursor may be moved around the
  581.                    screen and any character entered. Colour and
  582.                    graphics codes may also be used (See the chapter on
  583.                    keyboard definitions for easy ways to enter codes).
  584.  
  585.                    Frames that have been edited in this way may be
  586.                    saved to the carousel and displayed when required,
  587.                    but no facilities are provided in SuperTex to
  588.                    upload such frames to a Videotex service.
  589.  
  590. Mouse Select     - Enable/Disable selection of routes by clicking with
  591.                    mouse whilst on line.
  592.  
  593.                    An 'Off' or 'On' sub-menu  is offered. When turned
  594.                    on, route options may be selected whilst on line by
  595.                    moving the pointer over the required route number
  596.                    and clicking with the left button.
  597.  
  598.  
  599.                    If the route consists of more than one numeric
  600.                    digit, each digit is sent in turn.
  601.  
  602.  
  603.                      Chapter 5. Key Redefinitions
  604.                      ----------------------------
  605.  
  606. Certain keys are redefined by SuperTex to serve special purposes and
  607. these are listed below.
  608.  
  609. There may well be other keys that are redefined, but these are all I
  610. have come across.
  611.  
  612. At all times:-
  613.  
  614. Del               - Store current frame in next place in Carousel
  615. Shift - Del       - Recall next frame from Carousel to screen
  616. Amiga - Del       - Print current frame.
  617. Help              - Toggle Frame Edit mode on and off.
  618. Amiga - Help      - Display current configuration.
  619. Enter on NumPad   - Produces Prestel hash '#'
  620. NumPad Dot '.'    - Produces Prestel hash '#'
  621. NumPad '*'        - Produces '*'
  622. NumPad '-'        - Produces '*'
  623.  
  624. When in Edit mode, or editing a mailbox frame:-
  625.  
  626. F1                - Red foreground
  627. F2                - Green foreground
  628. F3                - Yellow foreground
  629. F4                - Blue foreground
  630. F5                - Purple foreground
  631. F6                - Cyan foreground
  632. F7                - White foreground
  633. F8                - Double Height characters
  634. F9                - Flashing characters on
  635. F10               - Flashing characters off
  636.  
  637. Alt - F1          - Red Graphics
  638. Alt - F2          - Green Graphics
  639. Alt - F3          - Yellow Graphics
  640. Alt - F4          - Blue Graphics
  641. Alt - F5          - Purple Graphics
  642. Alt - F6          - Cyan Graphics
  643. Alt - F7          - White Graphics
  644. Alt - F8          - Double Height characters
  645. Alt - F9          - Set normal (black) background
  646. Alt - F10         - Set background colour
  647.  
  648.  
  649.                                  END
  650.  
  651.